home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / comm / zsv_101.zip / ZSVIEW.DOC < prev    next >
Text File  |  1996-05-14  |  22KB  |  721 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                  
  18.  
  19.  
  20.                  ZSView - A viewer for ALLFILE.DIR
  21.                            
  22.                            
  23.                            
  24.                            
  25.                            
  26.                            
  27.                            
  28.                            
  29.                            
  30.                            
  31.                            
  32.                            
  33.                            
  34.                            
  35.                            
  36.                            
  37.                            
  38.                            
  39.                            
  40.                            
  41.                            
  42.                            
  43.                            
  44.                            
  45.                            
  46.                            
  47.                            
  48.                            
  49.                            
  50.                            
  51.                            
  52.                            
  53.                            
  54.                            
  55.                            
  56.                            
  57.                            
  58.                            (C) 1996   End Users, Inc.
  59.  
  60.                                                                           
  61.  
  62.  
  63.                            Table of Contents
  64.  
  65.      Overview.................................................... 2
  66.      Before you begin............................................ 3
  67.      ZSView...................................................... 4
  68.      Usage....................................................... 4
  69.      Options..................................................... 4
  70.      Main Index.................................................. 5
  71.      File Viewing................................................ 6
  72.      Sort Menu................................................... 6
  73.      Save........................................................ 7
  74.      Files Needed / Files Deleted................................ 8
  75.      Error Messages.............................................. 9
  76.      Additional Notes............................................10
  77.      Speed.......................................................10
  78.      Disclaimer..................................................10
  79.      Revision History............................................11
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                    - 1 -                         ZSView.DOC
  121.  
  122.  
  123.      Overview:   
  124.          
  125.          ZSView is a dedicated viewer for the file listings contained in
  126.      ALLFILE.DIR.  ZSView will also handle the individual directories in
  127.      ALLFILES.ZIP as a whole, as if they were all contained in ALLFILE.DIR,
  128.      creating an index for all 97 directories.  ZSView will handle any 
  129.      individual directory up to about 2 Meg.
  130.          
  131.          ZSView can also sort the file listings in a directory by Name,
  132.      Date or Size.  And ZSView can handle the multiline file descriptions 
  133.      up to 50 lines per listing.
  134.  
  135.          ZSView is written in QB 4.0, so it will run on an XT (although 
  136.      the sorting routines may be quite slooow on large directories).
  137.          
  138.          Also included in the package is PRETREAT.  This program is 
  139.      run once before using either ZSView or ZS.  PRETREAT corrects
  140.      problems in ALLFILE.DIR or the file directories which would cause
  141.      trouble for the search and sort routines in ZSView or ZS.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                    - 2 -                         ZSView.DOC
  181.  
  182.  
  183.      Before you begin:
  184.          If this is the first time you are running ZSView (or ZS)
  185.      then you must run PRETREAT.EXE before you run ZSView (or ZS).
  186.          PRETREAT corrects four problems in ALLFILE.DIR or the file
  187.      directories by use of these three options:
  188.  
  189.              PRETREAT   T X F
  190.  
  191.              Options:  T -  Tabs are converted to 7 spaces. (Although in
  192.                             the latest ALLFILE.DIR {4-2-96} there were
  193.                             no tabs used.)
  194.  
  195.                        X -  Useless lines with "@X80" contaminating the 
  196.                             filename area are removed.
  197.                             Simultaneously, any lines longer than 80
  198.                             characters are shortened to contain only
  199.                             the first 80.
  200.                             
  201.                        F -  That portion of the DIR98 listing in 
  202.                             ALLFILE.DIR (between the two 
  203.                             =================== lines) which doesn't obey
  204.                             the rule whereby multiline descriptions are 
  205.                             marked off with a vertical bar, "|", is
  206.                             changed to comply.  (This is not necessary 
  207.                             for the files in ALLFILES.ZIP -- no DIR98!.)
  208.                             The few blank lines left and the two 
  209.                             =================== lines cause an 
  210.                             inconsequential problem when the file is 
  211.                             sorted:  they all appear at the top or bottom
  212.                             depending upon the type of sort done.
  213.  
  214.          The options for PRETREAT may be run together or individually
  215.      as circumstances dictate.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                    - 3 -                         ZSView.DOC
  241.  
  242.  
  243.      ZSView:
  244.         
  245.          ZSView is written in QB 4.0 and runs in glorious 16 color 80 x 25 
  246.      text mode.  ZS can be either in the directory with the files being 
  247.      searched or on the path.
  248.  
  249.         
  250.         
  251.         
  252.      Usage:                         
  253.      
  254.          ZSView 
  255.      
  256.      That's it!  No options are needed.  ZSView will scan the current
  257.      directory to determine which set of directories is being viewed.
  258.      ZSView first looks for a file called ALLFILE.DIR.  When that's found,
  259.      ZSView then looks for the associated index file, ALLFILE.IDX.  If
  260.      this is the first time you're running ZSView (or if you've had to
  261.      delete the index previously) then an index file will be created.
  262.      Once that's done without error, you'll be placed into the Main Index,
  263.      the table of contents for ALLFILE.DIR.
  264.          If the hard drive directory you're in doesn't contain ALLFILE.DIR,
  265.      then ZSView will look for a file called DIR01.  If found, ZSView
  266.      assumes you are viewing the individual directories and then looks for
  267.      the associated index file ALLFILES.IDX.  If the index file isn't
  268.      found, ZSView will create it and then launch you into the Main Index.
  269.          If neither ALLFILE.DIR or DIR01 is found, you will be dumped back
  270.      to the DOS prompt with an error message about not being able to find
  271.      any files to view.  If you were trying to view the individual 
  272.      directories contained in ALLFILES.ZIP and were simply missing DIR01, 
  273.      then after you restore DIR01 you should delete ALLFILES.IDX and rerun
  274.      ZSView to recreate a new index.
  275.  
  276.  
  277.  
  278.  
  279.      Options:
  280.  
  281.          Actually, there is an option you can use.  If you wish ZSView to
  282.      start up in a specific directory, then include that number on the
  283.      command line:
  284.  
  285.          ZSView ##
  286.  
  287.      and ZSView will launch you into that directory for immediate viewing.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                    - 4 -                         ZSView.DOC
  301.  
  302.  
  303.      Main Index:
  304.  
  305.           When ZSView begins (assuming the IDX file exists) it will place
  306.      you into the Main Index.  This is a table of contents for the
  307.      directories contained in ALLFILE.DIR or the individual directories
  308.      originally packed in ALLFILES.ZIP.
  309.  
  310.          A reverse video highlight bar will tell you which directory is
  311.      currently under consideration.  Hitting "Enter" will allow you to 
  312.      view the contents of that directory.
  313.          For other directorie